home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / diskutil / dcdskinf.lzh / DISKINFO.DOC < prev   
Text File  |  1990-11-09  |  8KB  |  267 lines
  1. DC DISK INFO v1.0
  2.  
  3. November 9, 1990
  4.  
  5. Program by Keith Gerdes
  6.  
  7. Copyright (c) 1990 Double Click Software
  8.  
  9. This program is released as FREEWARE.  You may copy and distribute it
  10. freely, but please leave this archive intact.
  11.  
  12. DC Disk Info is used to give you a quick 'snapshot' of any disk.  You will
  13. get visual representation of the file allocation on your disk, plus certain
  14. statistics about the disk.
  15.  
  16. ====================
  17. DC KeyTop v1.2 users
  18. ====================
  19. If you use DC Desktop, please also download the file DCKEY12B.ARC which
  20. contains the new DC KeyTop v1.2b
  21.  
  22. You will need the new DC KeyTop v1.2b if:
  23.  
  24. 1) You currently use DC KeyTop, and
  25.  
  26. 2) You install DC DISK INFO as memory resident, and
  27.  
  28. 3) You own DC Desktop v1.2 or greater.
  29.  
  30. If you have DC Desktop v1.0, then you do not need DC KeyTop 1.2b, and can run
  31. DC DISK INFO just fine.  In fact, do not run DC KeyTop v1.2b with the
  32. DC Desktop v1.0, or it will cause a reset of your machine!
  33.  
  34. If you do not use DC KeyTop, then you can still run DC DISK INFO.
  35.  
  36. Again, DC KeyTop is not necessary for DC DISK INFO to run as described below.
  37. You just get an extra treat when DC KeyTop v1.2b is used.  In combination
  38. with DC KeyTop, DC DISK INFO will acts as a desk accessory, not as a program!
  39.  
  40. ==================
  41. NOTE
  42. ==================
  43. If you DO NOT run the new DC KeyTop v1.2b, but instead use DC KeyTop v1.2a
  44. or DC KeyTop v1.2, the system will 'hang' after DC DISK INFO runs (if it is
  45. memory resident).
  46.  
  47.  
  48. ==================
  49.      WARNING
  50. ==================
  51. If you configure DC DISK INFO to calculate files and folders used, we
  52. STRONGLY recommend that you use FOLDRXXX.PRG.
  53.  
  54. Double Click Software can not assume any responsibility for disk data
  55. damage as a result of using this program and hitting the '40 folder' bug.
  56. Use FOLDRXXX.PRG if you wish to completely safeguard against this problem.
  57.  
  58. You should be using FOLDRXXX.PRG anyway, regardless of whether you use
  59. DC DISK INFO.
  60.  
  61.  
  62. ====================
  63. INSTALLATION
  64. ====================
  65.  
  66. >To INSTALL DC DISK INFO if you have DC DESKTOP, do this:
  67. ---------------------------------------------------------
  68.  
  69. 1) Copy DCDSKINF.PRG to your AUTO folder.  When DC DISK INFO runs, it will
  70.    install itself in memory, and register with the DC Desktop.
  71.    
  72.    - or -
  73.  
  74. 1) Execute DCDSKINF.PRG from the desktop.  You will be presented with an
  75.    alert box asking you whether you want to RUN, INSTALL or QUIT the program.
  76.  
  77. 2) Click on INSTALL.  If DC Desktop is present, it will install itself in
  78.    memory and register with DC Desktop.
  79.  
  80.  
  81. ====================
  82. RUNNING
  83. ====================
  84.  
  85. >To RUN DC DISK INFO from the desktop, follow these steps:
  86. ----------------------------------------------------------
  87.  
  88. 1) Execute DCDSKINF.PRG from the desktop.  You will be presented with an
  89.    alert box asking you whether you want to RUN, INSTALL or QUIT.
  90.    
  91. 2) Click on RUN.  The screen will clear and you will be asked to enter a
  92.    drive letter.
  93.  
  94. 3) Press one key out of the letters displayed on the screen.
  95.  
  96. 4) You will be prompted whether or not to determine the files and folders
  97.    on that drive.  Press <Y> or <N>.
  98.  
  99. 5) The FAT of the chosen disk will be scanned and a graphic representation
  100.    of your file layout will be displayed, along with certain statistics.
  101.  
  102. 6) Press a key or the LEFT MOUSE BUTTON to repeat.
  103.  
  104.  
  105. >To RUN DC DISK INFO (installed) from DC Desktop, do this:
  106. ----------------------------------------------------------
  107.  
  108. 1) Click on a drive icon on the desktop until it is selected.
  109.  
  110. 2) Press the <ALTERNATE>+<S> keys at the same time.
  111.  
  112. 3) Depending on your configuration, you may be prompted if you want the
  113.    file and folder count to be calculated.  Press the <Y> or <N> key.
  114.  
  115. 4) The file allocation and drive statistics will be displayed for the
  116.    icon you chose from the desktop.
  117.  
  118. 5) Press a key or the LEFT MOUSE BUTTON to return to the desktop.
  119.  
  120. ====
  121. NOTE
  122. ====
  123. DC DISK INFO must be INSTALLED as memory resident for it to work as described
  124. directly above.
  125.  
  126. ====================
  127. QUITTING
  128. ====================
  129.  
  130. >TO QUIT DC DISK INFO, do this:
  131. -------------------------------
  132.  
  133. 1) Press either the <ESC> or <UNDO> key instead of a drive letter.
  134.  
  135.  
  136. ====================
  137. CONFIGURATION
  138. ====================
  139.  
  140. DC DISK INFO has three simple possible configurations.
  141.  
  142. When you run DC DISK INFO, it can either:
  143.  
  144. 1) Calculate the files and folders on the disk automatically, or
  145.  
  146. 2) Not calculate the files and folders, or
  147.  
  148. 3) Prompt you as to whether to calculate the files and folders.
  149.  
  150.  
  151. >To configure DC DISK INFO, do this:
  152. ------------------------------------
  153.  
  154. 1) Copy the DCDI_CFG.PRG and DCDSKINF.PRG files to the same location.
  155.    This is a temporary location just for configuration.
  156.  
  157. 2) Run the program DCDI_CFG.PRG from the desktop.  You will be presented
  158.    with an alert asking you:
  159.  
  160.    +---------------------+
  161.    |  Calculate Files    |
  162.    |  and Folders?       |
  163.    |                     |
  164.    | |Yes| |No| |Prompt| |
  165.    +---------------------+
  166.  
  167. 3) Click on the appropriate button.  The configurator will attempt to
  168.    save this information back to the DCDSKINF.PRG file.  If it can't
  169.    locate it, it will tell you.
  170.  
  171. 4) You can now copy DCDSKINF.PRG to you AUTO folder, if you have DC Desktop.
  172.  
  173. ====
  174. NOTE
  175. ====
  176. Be certain you have the files in the same place.  The configurator just
  177. looks in the current directory for the file named DCDSKINF.PRG
  178.  
  179. DO NOT copy DCDI_CFG.PRG to your AUTO folder, it is not designed to run
  180. from the AUTO folder on bootup.
  181.  
  182. ====================
  183. ANOTHER NOTE
  184. ====================
  185. If you do not calculate files and folders, the volume label will not be
  186. displayed.
  187.  
  188.  
  189. =====================
  190. DISPLAYED INFORMATION
  191. =====================
  192.  
  193. * FAT (File Allocation Table) map
  194.  
  195.   Each character represents a cluster or a _group_ of clusters which
  196.   make up the FAT.  
  197.  
  198.    . = clusters unused
  199.    X = clusters used
  200.    x = clusters mixed (used/empty)
  201.    B = clusters marked bad
  202.  
  203.   Note: 1] Whenever x's are mixed among X's, this indicates fragmentation of
  204.            disk space.  (ie. XXXxXXxXXXXxxX )
  205.  
  206.         2] x's leading into or trailing a group of X's is natural.
  207.            (ie. XX xXXXXXx XXX )
  208.         
  209.         3] B's may indicate one or more clusters bad in a group, if a
  210.            character represents more than one cluster
  211.  
  212. * Extended space usage information for a drive.
  213.  
  214. At the bottom of your screen you will see:
  215.  
  216. Drive X info:
  217.  
  218.  Free Space  :    xxxxx bytes  xxx Mb  xx%  |  Volume Label  :  name
  219.  Used Space  :    xxxxx bytes  xxx Mb  xx%  |  # Folders     :  xxx
  220.  Total Space :    xxxxx bytes  xxx Mb       |  # Files       :  xxx
  221.  Marked Bad  :    xx                        |  Clusters/char :  xx
  222.  
  223. ====
  224. NOTE
  225. ====
  226.  
  227. All space calculations are based upon clusters used or free, and therefore
  228. are accurate to the nearest size of a cluster.  In other words, the sizes
  229. reported are sizes according to cluster count, not actual file sizes summed.
  230.  
  231. Where:
  232.  
  233.     Free Space is the remaining free space
  234.     Used Space is the total used space
  235.     Total Space is the maximum storage of the disk
  236.     Marked bad is a count of all sectors marked as bad on the disk
  237.     Volume Label is obvious
  238.     # Folders is the count of folders on the disk
  239.     # Files is the count of files on the disk
  240.     Clusters/char is the number of clusters represented by each character
  241.     and is determined according to:  number of sectors on the drive / 1600
  242.  
  243.     xxxxx bytes is the bytes free/used/total
  244.     xxx Mb is the free/used/total space in Megabytes
  245.         this may also be xxx Kb for Kilobytes
  246.     xx% is the percentage free/used out of 100%
  247.  
  248.  
  249. ==========
  250. TALK TO US
  251. ==========
  252. If you would like to see a feature in any of our products, please do
  253. not hesitate to tell us what you need!
  254.  
  255. Call us if you have any questions too!
  256.  
  257. You can reach us at:
  258.  
  259. Voice:         (713)977-6520
  260.  
  261. Online:
  262. =======
  263. GEnie:         DOUBLE-CLICK (CATegory 30)
  264. CompuServe:    75300,577    (go ATARIVend, area 13)
  265. The DC BBS:    (713)944-0108
  266. Usenet:        uace0@menudo.uh